package com.xp.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.xp.entity.User;
import com.xp.utils.Result;

import java.util.List;

/**
 * 用户服务接口
 * 
 * @author AI Assistant
 * @since 2024-01-01
 */
public interface UserService {

    /**
     * 分页查询用户列表
     * 
     * @param page 分页对象
     * @param username 用户名（可选）
     * @param email 邮箱（可选）
     * @param status 状态（可选）
     * @return 分页结果
     */
    Result<IPage<User>> getUserPage(Page<User> page, String username, String email, Integer status);

    /**
     * 获取所有启用的用户
     * 
     * @return 用户列表
     */
    Result<List<User>> getEnabledUsers();

    /**
     * 根据ID获取用户详情
     * 
     * @param id 用户ID
     * @return 用户详情
     */
    Result<User> getUserById(Long id);

    /**
     * 创建用户
     * 
     * @param user 用户信息
     * @return 操作结果
     */
    Result<Object> createUser(User user);

    /**
     * 更新用户
     * 
     * @param id 用户ID
     * @param user 用户信息
     * @return 操作结果
     */
    Result<Object> updateUser(Long id, User user);

    /**
     * 删除用户
     * 
     * @param id 用户ID
     * @return 操作结果
     */
    Result<Object> deleteUser(Long id);

    /**
     * 更新用户状态
     * 
     * @param id 用户ID
     * @param status 状态
     * @return 操作结果
     */
    Result<Object> updateUserStatus(Long id, Integer status);
}